home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Aminet 8
/
Aminet 8 (1995)(GTI - Schatztruhe)[!][Oct 1995].iso
/
Aminet
/
dev
/
misc
/
HWGRCSmanp12f.lha
/
HWGRCS
/
hwgrcs
/
man
/
rlog.man
< prev
Wrap
Text File
|
1993-01-19
|
7KB
|
199 lines
RLOG(1) USER COMMANDS RLOG(1)
NAME
rlog - print log messages and other information about RCS
files
SYNOPSIS
rlog [ _o_p_t_i_o_n_s ] _f_i_l_e ...
DESCRIPTION
rlog prints information about RCS files.
Pathnames matching an RCS suffix denote RCS files; all oth-
ers denote working files. Names are paired as explained in
ci(1).
rlog prints the following information for each RCS file: RCS
pathname, working pathname, head (i.e., the number of the
latest revision on the trunk), default branch, access list,
locks, symbolic names, suffix, total number of revisions,
number of revisions selected for printing, and descriptive
text. This is followed by entries for the selected revi-
sions in reverse chronological order for each branch. For
each revision, rlog prints revision number, author,
date/time, state, number of lines added/deleted (with
respect to the previous revision), locker of the revision
(if any), and log message. All times are displayed in Coor-
dinated Universal Time (UTC). Without options, rlog prints
complete information. The options below restrict this out-
put.
-L Ignore RCS files that have no locks set. This is con-
venient in combination with -h, -l, and -R.
-R Print only the name of the RCS file. This is convenient
for translating a working pathname into an RCS pathname.
-h Print only the RCS pathname, working pathname, head,
default branch, access list, locks, symbolic names, and
suffix.
-t Print the same as -h, plus the descriptive text.
-b Print information about the revisions on the default
branch, normally the highest branch on the trunk.
-d_d_a_t_e_s
Print information about revisions with a checkin
date/time in the ranges given by the semicolon-separated
list of _d_a_t_e_s. A range of the form _d_1<_d_2 or _d_2>_d_1
selects the revisions that were deposited between _d_1 and
_d_2 inclusive. A range of the form <_d or _d> selects all
revisions dated _d or earlier. A range of the form _d< or
>_d selects all revisions dated _d or later. A range of
GNU Last change: 1991/08/22 1
RLOG(1) USER COMMANDS RLOG(1)
the form _d selects the single, latest revision dated _d
or earlier. The date/time strings _d, _d_1, and _d_2 are in
the free format explained in co(1). Quoting is normally
necessary, especially for < and >. Note that the
separator is a semicolon.
-l[_l_o_c_k_e_r_s]
Print information about locked revisions only. In addi-
tion, if the comma-separated list _l_o_c_k_e_r_s of login names
is given, ignore all locks other than those held by the
_l_o_c_k_e_r_s. For example, rlog -L -R -lwft RCS/* prints the
name of RCS files locked by the user wft.
-r[_r_e_v_i_s_i_o_n_s]
prints information about revisions given in the comma-
separated list _r_e_v_i_s_i_o_n_s of revisions and ranges. A
range _r_e_v_1:_r_e_v_2 means revisions _r_e_v_1 to _r_e_v_2 on the same
branch, :_r_e_v means revisions from the beginning of the
branch up to and including _r_e_v, and _r_e_v: means revisions
starting with _r_e_v to the end of the branch containing
_r_e_v. An argument that is a branch means all revisions
on that branch. A range of branches means all revisions
on the branches in that range. A branch followed by a .
means the latest revision in that branch. A bare -r
with no _r_e_v_i_s_i_o_n_s means the latest revision on the
default branch, normally the trunk.
-s_s_t_a_t_e_s
prints information about revisions whose state attri-
butes match one of the states given in the comma-
separated list _s_t_a_t_e_s.
-w[_l_o_g_i_n_s]
prints information about revisions checked in by users
with login names appearing in the comma-separated list
_l_o_g_i_n_s. If _l_o_g_i_n_s is omitted, the user's login is
assumed.
-V_n Emulate RCS version _n when generating logs. See co(1)
for more.
-x_s_u_f_f_i_x_e_s
Use _s_u_f_f_i_x_e_s to characterize RCS files. See ci(1) for
details.
rlog prints the intersection of the revisions selected with
the options -d, -l, -s, and -w, intersected with the union
of the revisions selected by -b and -r.
EXAMPLES
rlog -L -R RCS/*
rlog -L -h RCS/*
GNU Last change: 1991/08/22 2
RLOG(1) USER COMMANDS RLOG(1)
rlog -L -l RCS/*
rlog RCS/*
The first command prints the names of all RCS files in the
subdirectory RCS that have locks. The second command prints
the headers of those files, and the third prints the headers
plus the log messages of the locked revisions. The last
command prints complete information.
ENVIRONMENT
RCSINIT
options prepended to the argument list, separated by
spaces. See ci(1) for details.
DIAGNOSTICS
The exit status is zero if and only if all operations were
successful.
IDENTIFICATION
Author: Walter F. Tichy.
Revision Number: 5.3; Release Date: 1991/08/22.
Copyright c 1982, 1988, 1989 by Walter F. Tichy.
Copyright c 1990, 1991 by Paul Eggert.
SEE ALSO
ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1),
rcsmerge(1), rcsfile(5)
Walter F. Tichy, RCS--A System for Version Control,
_S_o_f_t_w_a_r_e--_P_r_a_c_t_i_c_e & _E_x_p_e_r_i_e_n_c_e 15, 7 (July 1985), 637-654.
BUGS
The separator for revision ranges in the -r option used to
be - instead of :, but this leads to confusion when symbolic
names contain -. For backwards compatibility rlog -r still
supports the old - separator, but it warns about this
obsolete use.
GNU Last change: 1991/08/22 3